home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / findall.zip / FINDALL.DOC < prev   
Text File  |  1991-04-11  |  7KB  |  141 lines
  1.  
  2.                 FINDALL - "The file finder with a twist"
  3.  
  4.  
  5.         (The  name  FINDALL, the  FINDALL  program  itself,  and this
  6.         documentation are  Copyright (Copr) 1991 by Stephen C. Lenz.)
  7.  
  8.                                 
  9.                                   DESCRIPTION
  10.  
  11.         FINDALL is not just another file finder,  although it can and
  12.         probably will be used as a  normal file finder  because it is
  13.         VERY fast.  The "twist" is you can search for file names with
  14.         a search string when you can't remember the file's full name!
  15.  
  16.         I wrote this because  more than once I have looked for a file
  17.         whose full name escaped me (....I think it was SYS something,
  18.         or something SYS ....or something SYS something or....).  You
  19.         get the idea.
  20.  
  21.         Also,  while I was writing FINDALL,  I remembered the times I
  22.         wanted  to know how many  READ ONLY or SYSTEM or HIDDEN files
  23.         were on a particular disk drive, and had to track down a file
  24.         attribute manager because DOS's  ATTRIB command does not show 
  25.         hidden or system files!  So I included  the ability to search
  26.         for all occasions of any or all file attributes.
  27.  
  28.         I have already mentioned how fast FINDALL is. Please be aware
  29.         that FINDALL is at its fastest when searching for a full file
  30.         name and extension seperated by "." because the  program uses
  31.         only Interrupt 21,  service 4Eh,  and service 4Fh to find the
  32.         existence of a full file  name in a directory, then only when
  33.         the file is found does FINDALL read its name and description.
  34.         If you search for a partial  file name string,  or if you are
  35.         checking file attributes,  FINDALL is somewhat slower because
  36.         it will read the name and description of  EVERY file and do a
  37.         compare with the search string or attribute(s) specified.
  38.  
  39.                                 
  40.                                   OPERATION
  41.  
  42.         You can start FINDALL in 2 different ways:
  43.  
  44.         1)  If you just want to  search for a  file name or a partial 
  45.         file name, merely type FINDALL <Enter> and the FINDALL screen
  46.         will appear to prompt you for the file name or search string.
  47.         FINDALL will  default to start  at disk drive C:  and it will
  48.         continue to search all good disk drives on your system.
  49.  
  50.         2)  If you want to search for file attributes, or if you want
  51.         more than  25 rows on your screen (EGA, VGA),  or if you want
  52.         to start with drive A: or B:  (yes,  FINDALL does floppies!),
  53.         or if you  want to search 1 drive only,  or if you want help,
  54.         or if you want to suppress the beep, or if you want to search
  55.         non-stop,  then you must use the  command line. (I could have
  56.         included a pop-up menu,  but I wanted the code to be as small
  57.         and fast as possible).  You can,  of course,  use the command
  58.         line to start FINDALL to look for full file names or strings.
  59.  
  60.  
  61.  
  62.  
  63.         FINDALL Syntax:  FINDALL [[d:]SSpec /Options]
  64.         
  65.         Where:   d:  is a drive to START with.  If none is specified, 
  66.         C:  is  assumed.  You can  start with any  good drive letter,
  67.         including floppy A: or B:. If you specify the starting drive,
  68.         you  MUST  Use ":" (colon), but do  NOT  use "\" (backslash).
  69.         FINDALL is NOT case sensitive.
  70.         
  71.         SSpec is either a complete file name,  or a search string for
  72.         a file.  For example,  if SSpec = COM,  then COMMAND.COM will
  73.         show with both COM strings highlighted.
  74.         
  75.         Do NOT use "*" global or "?" wildcards. FINDALL will look for
  76.         ALL occurances of the search spec (SSpec).
  77.         
  78.         Options: 
  79.         /1 to search ONE drive only.           /? or ? or /help - this screen.
  80.         /4 for 43 screen rows.                 /5 for 50 screen rows.
  81.         /r searches for READ ONLY files.       /h searches for HIDDEN files.
  82.         /s searches for SYSTEM files.          /a searches for ARCHIVE files.
  83.         /n searches NON-STOP.                  /q quiet (no beeps).
  84.  
  85.         (FINDALL will sense the type of video adapter that is on your
  86.         computer system,  and will act accordingly,  so if you have a
  87.         monochrome or CGA (not EGA or VGA),  and you try to select 43
  88.         or 50 screen rows (lines), FINDALL will ignore the parameter,
  89.         and run in 25 row mode).
  90.         
  91.         Examples:
  92.         FINDALL c:exe /4 /1        will search for all occurances of 
  93.                                    "EXE" on drive C in 43 row mode.
  94.         
  95.         FINDALL /R/s               will find all READ ONLY and SYSTEM files.
  96.  
  97.         FINDALL a:command.com /1 /n /4 /q          will find all occurances
  98.                                                    of COMMAND.COM on drive
  99.                                                    A: only,  will display
  100.                                                    them non-stop in 43-line
  101.                                                    mode (EGA, VGA), and will
  102.                                                    not beep.
  103.  
  104.  
  105.  
  106.                                   FINALLY
  107.  
  108.         If you  find this  program useful,  and would  care to donate
  109.         $10 to the cause of further  program development,  my address
  110.         is at the bottom of this document.  A donation  of $25  along 
  111.         with a blank 5¼" 360k, or 3½" 720k or 1.44m  diskette and the
  112.         appropriate postage will get you the BASIC source code.
  113.  
  114.         I wrote and tested this program  on an IBM  PS/2  mdl 30-286,
  115.         with VGA color,  and a BONDWELL B10 286 laptop with CGA mono.
  116.         This  program was written in its entirety using the MICROSOFT
  117.         BASIC  Professional  Development System  v7.1,  and  utilizes
  118.         subroutines and functions from  CRESCENT SOFTWARE's  QuickPak
  119.         Professional Advanced Programming  Library.  The  program was
  120.         then linked with  CRESCENT SOFTWARE's  P.D.Q.,  the fantastic
  121.         linking library  that replaces the  huge and  very cumbersome 
  122.         libraries  that are  supplied with  MICROSOFT  BASIC  of  all
  123.         versions.  Neither the small size,  nor the speed of  FINDALL
  124.         could have been attained without the CRESCENT add-ons.
  125.  
  126.         IBM,  PS/2,  BONDWELL,  MICROSOFT,  Professional  Development
  127.         System, CRESCENT SOFTWARE,  QuickPak Professional, and P.D.Q.
  128.         are trademarks,  registered trademarks,  or service marks  of
  129.         their respective holders.
  130.  
  131.         The  name  FINDALL, the  FINDALL  program  itself,   and this
  132.         documentation are  Copyright (Copr) 1991 by  Stephen C. Lenz.
  133.  
  134.         Stephen C. Lenz
  135.         214 Broadway
  136.         Providence, RI 02903
  137.         (401) 272-5356
  138.         CIS 72431,3147
  139.         CHANNEL 1 BBS, Cambridge, MA (617) 354-8873
  140.         April 11, 1991
  141.